home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / hp379.arc / SP.DOC next >
Text File  |  1984-07-21  |  11KB  |  305 lines
  1.  
  2.                         SP: A PRINT SPOOLER
  3.                     for the IBM Personal Computer
  4.                             Version 3.79
  5.  
  6.                       Copyright Alan Jones 1983
  7.                          3717 Wildwood Drive
  8.                           Endwell, NY 13760
  9.                            (607) 754-2339
  10.                            June 27, 1984
  11.  
  12.  
  13.  
  14. SP is a software printer buffer to hold data intended for the printer.
  15. It works like the buffers that can be installed in the printer but the
  16. data is stored in RAM storage instead of in the printer.  The buffer
  17. is unloaded to the printer at the printer's speed while DOS proceeds
  18. at its speed.  The size of the buffer is specified as a parameter when
  19. SP is invoked.  For example,
  20.  
  21.             SP 14
  22.  
  23. will produce a buffer of 14KB (1KB = 1024 bytes).
  24.  
  25. The complete syntax is:
  26.  
  27.      SP [ss] [C=cc] [P=pp]
  28.  
  29. where:
  30.  
  31.         ss: size of buffer in kilobytes.  One kilobyte = 1024 bytes.
  32.             Maximum size is 62 KB.
  33.  
  34.         cc: number of copies desired.  Default: 1.
  35.  
  36.         pp: printer port desired (1, 2, or 3).  Default: 1.
  37.  
  38. NOTE:  You do not type the square brackets.  They merely indicate that the
  39. contents are optional.  For example, if you want to use printer port 2 with
  40. a buffer size of 20 KB, you would enter:
  41.  
  42.         SP 20 P=2
  43.  
  44. If you want to keep the previous buffer and only change the number of
  45. copies to 3 copies, enter:
  46.  
  47.         SP C=3
  48.  
  49. For the "C" and "P" you can enter either upper or lower case characters.
  50.  
  51. If the size parameter is omitted, a default buffer of 16KB is used.
  52.  
  53. The program will work for all work sent to the printer whether it is from
  54. the DOS TYPE command, a PrtSc command, a BASIC LLIST or LPRINT command, a
  55. print command from The Personal Editor, etc.
  56.  
  57.  
  58. TO STOP PRINTING
  59.  
  60. If you start a printout and decide you don't want it, press,
  61. simultaneously, Alt-LeftShift-PrtSc to flush the buffer.  You can also
  62. flush the buffer by turning the printer off and then back on.
  63.  
  64.  
  65.  
  66. TO PAUSE
  67.  
  68. If you want the printing to pause, hold down the ON LINE button until the
  69. printer stops (which it will do at the end of a line).  Pressing the ON
  70. LINE button again will allow printing to resume with no loss of data.
  71.  
  72.  
  73. CHANGING BUFFER SIZE
  74.  
  75. You can remove SP from the machine by specifying a buffer of zero.  That
  76. is:
  77.  
  78.       SP 0
  79.  
  80.  
  81. will return DOS to its original state unless another DOS extension is
  82. installed after SP such as FileCommand.
  83.  
  84. You can change the size of the buffer by re-invoking SP with the new
  85. parameter.  In this case, SP determines that there is already a copy
  86. present in the machine and just alters the size of the buffer of the
  87. older copy.  (This feature not available for DOS 2.0.  However, you can
  88. remove SP and then re-invoke it to get a different buffer size.)
  89.  
  90.  
  91.  
  92. MULTIPLE COPIES
  93.  
  94. To create multiple copies of a document, you must indicate to SP where the
  95. beginning and end of the document is.  To indicate the beginning of a
  96. document press Alt-LeftShift-B.  To indicate the end of a document press
  97. Alt-LeftShift-E.  Of course, if you have indicated only one copy, that is
  98. all you will get.  You can press the END indication when SP has gobbled up
  99. the text.  You don't have to wait until the first copy is printed.
  100.  
  101. One nice way of using the multiple copies is after the fact.  That is, if
  102. you just printed a document and decide you'd like another copy, from DOS
  103. indicate the TOTAL number of copies you want (2 or more) and then invoke
  104. the END indication.  SP will determine that one copy has already been
  105. printed and proceed to print the rest according to the quantity specified.
  106.  
  107. You have to be a bit careful.  Once you indicate the beginning of a
  108. document (Alt-LeftShift-B) that remains the beginning until you change it.
  109. If you print multiple copies of something and then send something else to
  110. the printer and again indicate the END, you will get a document from the
  111. most recent BEGIN.  This may or may not be what you want.
  112.  
  113.  
  114. MULTIPLE PRINTERS
  115.  
  116. SP can support more than one printer.  When you invoke SP it creates a
  117. buffer for the specified printer.  If you do not specify one, it will
  118. create a buffer for LPT1.  You can then re-invoke SP specifying another
  119. printer and a new buffer will be created.  From then on, the data going to
  120. the printer will enter the appropriate buffer and be printed on the
  121. appropriate printer.  When you give keyboard commands, SP does not know
  122. which printer they apply for so it uses them for all.  That is, if you
  123. flush the buffer (Alt-LeftShift-PrtSc) all buffers will be flushed.  If you
  124. indicate the end of a document, this will apply to all buffers.
  125.  
  126.  
  127.  
  128. CAVEATS:
  129.  
  130. When using with VisiCalc, do not specify a buffer larger than 23K with DOS
  131. 1.1 or 10K with DOS 2.0 since VisiCalc will not load (it cannot cross a 64K
  132. boundary during loading.)
  133.  
  134. There is a problem when using SP with the Personal Editor Version 1.0 on
  135. some occasions when quiting a file.  This has turned out to be a problem in
  136. PE.  To patch PE:  On a scratch disk, rename a copy of PE.EXE to XX and
  137. DEBUG XX.  Type E DS:56E7 and change 6 bytes of code to hex 90 by typing 90
  138. and pressing the space bar 6 times.  The previous contents of those bytes
  139. should be C7 06 56 EF 00 00.  Then use the debug command W (write) to write
  140. the file back out.  Then Q (quit) to leave DEBUG and rename XX back to
  141. PE.EXE.
  142.  
  143. When using it in some environments such as EasyWriter, there may be
  144. commands that allow you to stop the printer.  However, when SP is present,
  145. the program will be way ahead of the printer and will only stop sending
  146. data to the buffer.  In cases like this, turn off the printer and then turn
  147. back on again to stop printing.
  148.  
  149.  
  150. OPERATING ENVIRONMENTS
  151.  
  152. SP has been tested in the following environments:
  153.  
  154.    PrtSc command                   WordStar
  155.    DOS TYPE to printer             EasyWriter 1.1
  156.    BASIC LLIST                     VisiCalc
  157.    BASIC LPRINT                    With Communications
  158.    BASIC PRINT#                    The Personal Editor
  159.    Lotus 1-2-3                     Multiplan
  160.    PC-FILE                         PC-TALK
  161.  
  162. And with the following printers:
  163.  
  164.    IBM Printer and Printer-2       TI-800
  165.    C. Itoh PROWRITER               Okidata
  166.    Epson MX-80 or MX-80 F/T        NEC 7730
  167.  
  168.  
  169.  
  170. AVAILABILITY
  171.  
  172. Available from Alan Jones under the "user supported software" concept
  173. promoted by Jim Button.  See below.
  174.  
  175. COPYING
  176.  
  177. SP can be copied onto one of your own diskettes for use on your machine.
  178. In fact we recommend including it in your AUTOEXEC's so that it is always
  179. invoked.
  180.  
  181. DISCLAIMER.
  182.  
  183. In no event will the Author be liable to you for any damages, including any
  184. lost profits, lost savings or other incidental or consequential damages
  185. arising out of the use of or inability to use these programs, even if the
  186. Author has been advised of the possibility of such damages, or for any
  187. claim by any other party.
  188.  
  189. PERMISSION TO COPY:
  190.  
  191. Clubs and other non-profit organizations are granted permission by the
  192. author to freely copy these programs and documentation and share it with
  193. their members, so long as:
  194.  
  195. 1.  No price is charged for the software or documentation.  However, a
  196.     distribution cost may be charged for the cost of the diskette, so long
  197.     as it is not more than $10 total.
  198.  
  199. 2.  Club members are informed of the user-supported concept and encouraged
  200.     to support it with their donations.
  201.  
  202. 3.  The program or documentation are not modified in any way and are
  203.     distributed together.
  204.  
  205.  
  206. THE USER-SUPPORTED CONCEPT.
  207.  
  208.                         User-Supported Software
  209.        If you are using this program and find it to be of value
  210.                 your contribution will be appreciated.
  211.                           ($15 is suggested)
  212.  
  213.                             Alan Jones
  214.                          3717 Wildwood Drive
  215.                           Endwell, NY 13760
  216.  
  217.             Regardless of whether you make a contribution,
  218.           you are encouraged to copy and share this program.
  219.  
  220.  
  221.  
  222. User-supported software is an experiment in distributing computer
  223. programs, based on these beliefs:
  224.  
  225. 1.  That the value and utility of software is best assessed by the
  226.     user on his/her own system.
  227.  
  228. 2.  That the creation of personal computer software can and should
  229.     be supported by the computing community.
  230.  
  231. 3.  That copying of programs should be encouraged, rather than
  232.     restricted.
  233.  
  234. Anyone may request a copy of a user-supported program by sending a blank,
  235. formatted disk to the author of the program.  An addressed, postage-paid
  236. return mailer must accompany the disk (no exceptions, please).  A copy of
  237. the program, with documentation on the disk, will be sent by return mail.
  238. The program will carry a notice suggesting a contribution to the program's
  239. author.  Making a contribution is completely voluntary on the part of each
  240. user.
  241.  
  242. Free distribution of software and voluntary payment for its use eliminates
  243. costs for advertising and copy protection schemes.
  244.  
  245. Users obtain quality software at reduced cost.  They can try it out before
  246. buying, and do so at their own pace and in the comfort of their own home or
  247. office.  The best programs will survive, based purely on their quality and
  248. usefulness.
  249.  
  250. Please join the experiment.
  251.  
  252. If you believe in these ideals, your contribution is solicited to help make
  253. them work.
  254.  
  255. Many of you have written requesting an invoice so that you could initiate
  256. payment through your company accounting system.  The following invoice is
  257. provided for those of you in this category, or for those who wish an
  258. invoice for your tax records.  Perhaps it will serve the purpose.
  259.  
  260.  
  261.  
  262.                        --------------------
  263.                               INVOICE
  264.                        --------------------
  265.  
  266.  
  267.  
  268.  
  269.    Purchased from:
  270.        ALAN JONES
  271.        3717 Wildwood Drive
  272.        Endwell, NY 13760
  273.  
  274.  
  275.   DATE:     /     /                           Invoice No. 840211
  276.   --------------------------------------------------------------
  277.                                        PRICE     PRICE
  278.   PRODUCT                    QTY       EACH      EXTENDED
  279.   -------------------------  ---       -----     --------
  280.  
  281.   SP: A Print Spooler
  282.     program and
  283.     documentation             1         $15         $15
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.                                       SALES TAX      0
  291.  
  292.                           --------------------------------------
  293.                           PLEASE PAY THIS AMOUNT    $15    TOTAL
  294.   --------------------------------------------------------------
  295.  
  296.  
  297.  
  298. Please make check payable to :ALAN JONES
  299.  
  300.  
  301. You may retain this Invoice
  302. for your tax records.
  303.  
  304.  
  305.